Skip to content

feat: add Blog section with dev storytelling post#32

Merged
nitaibezerra merged 2 commits intomainfrom
docs/update-scraper-extraction
Feb 26, 2026
Merged

feat: add Blog section with dev storytelling post#32
nitaibezerra merged 2 commits intomainfrom
docs/update-scraper-extraction

Conversation

@nitaibezerra
Copy link
Contributor

Summary

  • 📝 Adds Blog section to the docs site using MkDocs Material's built-in blog plugin
  • 🏗️ First post: "6 dias, 36 PRs, 3 repos novos: desmembrando o monolito data-platform"
  • 🎨 Custom CSS to limit blog post width and hide TOC on blog pages
  • 📊 Mermaid diagrams for architecture before/after visualization

Files added/modified

  • mkdocs.yml — blog plugin config, extra_css, nav entry
  • docs/blog/index.md — blog index page
  • docs/blog/.authors.yml — author profiles
  • docs/blog/posts/2026-02-26-desmembrando-monolito.md — first blog post
  • docs/stylesheets/blog.css — blog-specific styling

Test plan

  • mkdocs serve renders blog at /docs/blog/
  • Blog post loads with Mermaid diagrams rendered
  • Post listing shows excerpt (cut at <!-- more -->)
  • Categories and author info display correctly
  • TOC hidden on blog pages, content width limited

🤖 Generated with Claude Code

nitaibezerra and others added 2 commits February 26, 2026 18:25
- Enable built-in blog plugin with excerpt separator
- Add first post: "6 dias, 36 PRs, 3 repos novos"
- Add author profile (nitai) with GitHub avatar
- Add custom CSS to limit blog post width (45em)
- Add Blog entry to navigation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ved narrative

Rewrites the monolith decomposition blog post with:
- Mermaid diagrams for architecture (flowchart + block diagrams)
- Emojis throughout headings, transitions and highlights
- Improved storytelling flow and context section for external readers
- Fix title slug (remove emoji from front matter title)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@nitaibezerra nitaibezerra merged commit 067233e into main Feb 26, 2026
1 check passed
@nitaibezerra nitaibezerra deleted the docs/update-scraper-extraction branch February 26, 2026 22:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant